home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -in_the_mag- / mousewheel / newmouse12 / newmouse.doc < prev    next >
Text File  |  2000-03-02  |  6KB  |  317 lines
  1.  
  2.  
  3.  
  4.                                NewMouse 1.2
  5.  
  6.                      The Ultimate Serial Mouse Driver
  7.  
  8.                 Copyright (c) 1998-1999 by Alessandro Zummo
  9.  
  10.                             All Rights Reserved
  11.  
  12.                    Commercial use is strictly forbidden
  13.  
  14.                                  CardWare
  15.  
  16.  
  17. Note
  18. ----
  19.  
  20.  This version of NewMouse wouldn't have been released without
  21.  the support of Power Computing Ltd. . In fact, i've received
  22.  very few postcards, gifts or free copies from whom
  23.  is using NewMouse API in their commercial/shareware
  24.  programs. I've never asked a gift, but if you earn
  25.  moneys with your program please consider to send
  26.  me a free copy or a keyfile.
  27.  
  28.  
  29.  
  30. Introduction
  31. ------------
  32.  
  33.  Even if there are many mouse drivers on aminet, NewMouse is the
  34.  only one with all these features:
  35.  
  36.  - Works with the most common mice
  37.  
  38.  - Wheel support
  39.  
  40.  - Allows Drag'n'Drop with MUI
  41.  
  42.  - Works with IBrowse
  43.  
  44.  - It's compliant to MouseWheel for wheel operations
  45.  
  46.  - It's fast, some sections are written in asssembly
  47.  
  48.  - It's able to work on different devices than serial.device
  49.  
  50.  - It's OS friendly and compliant to RKM guidelines
  51.  
  52.  - Hot (un)plug of the mouse is supported.. i.e. you can 
  53.    unplug and plug the mouse while NewMouse is running
  54.    (however you may damage your Amiga by doing this)
  55.  
  56.  
  57. Note
  58. ----
  59.  
  60.  It seems that NewMouse is the new "de facto" standard for wheeled mice
  61.  handling on the Amiga platform. I would be very fine if it will be supported
  62.  by the next AmigaOS release. You know where to send you request to...
  63.  I would be also happy if i will receive a free copy of every commercial product 
  64.  that adheres to the NewMouse standard.. hint, hint :-)
  65.  
  66.  
  67. Copyright
  68. ----------
  69.  
  70.  This software is subject to the "Standard Amiga FD-Software Copyright Note"
  71.  It is Cardware as defined in paragraph 4c. 
  72.  If you like it and use it regularly please send a postcard to the author.
  73.  For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  74.  
  75.  Commercial distribution is *strictly* forbidden without
  76.  a written agreement with the author.
  77.  
  78. Usage
  79. -----
  80.  
  81.  NewMouse DEVICE,UNIT/N,7BIT/S,P=PROTOCOL/K,PO=PROTOCOLOPTIONS/K
  82.  
  83.  These are the defaults:
  84.  
  85.  DEVICE   = serial.device
  86.  UNIT     = 0
  87.  PROTOCOL = LOGITECH
  88.  
  89.  
  90.  The following protocols are actually available:
  91.  (If you have a mouse other than those listed here it doesn't 
  92.   necessarly mean that it will not work...)
  93.  
  94.  LOGITECH
  95.  
  96.   - Mice
  97.  
  98.    Logitech PilotMouse+
  99.    Logitech FirstMouse+
  100.    Logitech MouseMan+
  101.    Microsoft Intellimouse, even the "serial and PS2/compatible" one
  102.    A4Tech WWW-11 and WWW-5
  103.  
  104.   - Features
  105.  
  106.    Wheel
  107.    Third button
  108.    Red button
  109.  
  110.   - Options
  111.  
  112.    none
  113.  
  114.  
  115.  OLDLOGITECH
  116.  
  117.   - Mice
  118.  
  119.    Logitech M-Mxx series (NOT M-Sxx, they're PS2 mice)
  120.    Other manufacturers M-Mxx mice (they're Logitech inside)
  121.  
  122.   - Features
  123.  
  124.    Wheel
  125.    Third button
  126.  
  127.   - Options
  128.  
  129.    NOWHEEL/S
  130.  
  131.  
  132.  LOGITECHFX
  133.  
  134.   - Mice
  135.  
  136.    Logitech Trackball Marble FX
  137.  
  138.   - Features
  139.  
  140.    Wheel mode is enabled with the red button pressed
  141.    Third button
  142.  
  143.   - Options
  144.  
  145.    NOWHEEL/S, DELTA/N
  146.  
  147.    NOWHEEL: The wheel mode will be disabled (not yet implemented).
  148.    DELTA:   The wheel will trigger a movement only every <DELTA> steps.
  149.  
  150.  
  151.  MICROSOFT
  152.  
  153.   - Mice
  154.  
  155.    Microsoft serial mouse 2.0A
  156.    Agiler Mouse Model Nr. 200
  157.  
  158.   - Features
  159.  
  160.    none
  161.  
  162.   - Options
  163.  
  164.    none
  165.  
  166.  MOUSESYSTEM
  167.  
  168.   - Mice
  169.  
  170.    BTC MUSG2
  171.  
  172.   - Features
  173.  
  174.    Third button
  175.  
  176.   - Options
  177.  
  178.    none
  179.  
  180.  
  181.  If your mouse is not listed here
  182.  but works succesfully with NewMouse, please
  183.  write me an email.
  184.  
  185.  If your mouse doesn't work with NewMouse but you're sure it's
  186.  a serial mouse, write me an email. I'll try to make it working.
  187.  
  188.  
  189.  
  190. Who is currently supporting the MouseWheel standard?
  191. ----------------------------------------------------
  192.  
  193.  NList.mcc, from Gilles Masson.
  194.  
  195.  MuiWheel, a way to use the wheel with MUI (Aminet)
  196.  
  197.  IntuiWheel, a patch for commodities.library/ParseIX (n/a, ask me).
  198.  
  199.  Voyager, AmIRC
  200.  
  201.  Many mui classes
  202.  
  203.  DirectoryOPUS Magellan
  204.  
  205.  many others...
  206.  
  207.  
  208. FAQs
  209. ----
  210.  
  211.  Q: Can i connect a PC mouse on the Amiga mouse port using NewMouse?
  212.  A: No, you can't. You need a spare serial port.
  213.  
  214.  Q: Can i use a PS/2 mouse with NewMouse?
  215.  A: No, you can't. You need a real RS232 mouse.
  216.  
  217.  Q: Sometimes the pointer has a sort of "jittering"
  218.  A: Try disconnecting the other mouse from the Amiga mouse port
  219.  
  220.  
  221. Future
  222. ------
  223.  
  224.  If requested, i'll be happy to implement other 
  225.  protocols, even for a non wheeled mouse, but
  226.  i need to have some feedback for this.
  227.  
  228.  I would like to support changing the mouse
  229.  baud rate, if someone can tell me how.
  230.  
  231.  
  232. Developer infos
  233. ---------------
  234.  
  235.  A new standard is defined. 
  236.  Check the include newmouse.h in the archive.
  237.  It will be supported by the next MUI release.
  238.  
  239.  
  240. History
  241. -------
  242.  
  243.   1.0 (10.07.1998) - First public release
  244.  
  245.   1.1 (16.02.1999) + Hot plug handling
  246.                    + Little speedup
  247.                    - Fixed a little bug
  248.                    - Many protocols added
  249.  
  250.   1.2 (07.10.1999) - Y movements were swapped with the mousesystem protocol
  251.                    + New options for the LogitechFX protocol
  252.                    - Minor changes
  253.                    + FAQs added
  254.  
  255. Sponsors
  256. --------
  257.  
  258.  Many thanks to Power Computing Ltd. for supporting my work.
  259.  
  260.  
  261. Greetings
  262. ---------
  263.  
  264.  Dave Harris                The author of MouseWheel.
  265.                             He had the original idea 
  266.                             about the wheel.
  267.  
  268.  Gilles Masson              For his tests and for the support
  269.                             in his NList MUI class.
  270.  
  271.  Ralph Torchia              For his beta-testing and for his
  272.                             precious suggestions.
  273.  
  274.  Torsten Blume              For his beautiful postcard. The first
  275.                             i've received.
  276.  
  277.  Oliver Wagner              For the AmIRC 3.0 keyfile.
  278.  
  279.  Audun Evensen              He is spreading newmouse.h between
  280.                             programmers :-)
  281.  
  282.  Sven Thoennissen           Beta testers and happy users
  283.  Dean Husby                 (in no particular order)
  284.  Carol Harmond
  285.  Gregor Rébel
  286.  Stefan Schindler
  287.  Ralf Heinert
  288.  Alex Pagnoni
  289.  Thomas Igracki
  290.  Oliver Kreuzenbeck
  291.  Stefan Stuntz
  292.  Philippe Devilard 
  293.  Vit Sindlar
  294.  
  295.   ... sorry if i missed someone.
  296.  
  297. Author
  298. ------
  299.  
  300.  Email: 
  301.  
  302.   azummo@ita.flashnet.it
  303.  
  304.  
  305.  Homepage: 
  306.  
  307.   http://freepage.logicom.it/azummo/
  308.  
  309.  
  310.  Snail mail:
  311.  
  312.   Via S. F. d'Assisi, 27
  313.   10121 Turin
  314.   Italy
  315.  
  316.  
  317.